Reject an intercompany transfer (pending_approval -> rejected)
Rejects an intercompany transfer sitting in pending_approval status,
advancing it to rejected and recording rejected_by, rejected_at,
and optional rejection_notes. Internal transfers cannot be rejected.
State guard: returns 400 when the transfer is not intercompany or
when status is not pending_approval. AUDIT-089 fires the
transfer.rejected broadcast to BOTH entities.
Requires inventory:approve scope. Idempotent via Idempotency-Key.
Authorizations
API key issued per entity via Settings > Developers > API Keys.
Each key carries scopes (e.g. orders:read, products:write).
Bearer token format: Authorization: Bearer ark_live_ent_Test keys use ark_test_ent_. Both are issued per entity
via Settings > Developers > API Keys.
Headers
Client-generated unique key for idempotent POST/PATCH/DELETE operations. Alias for the Idempotency parameter. Max 255 chars. On retry with the same key, the original response is returned without re-executing the operation. Keys expire after 24 hours.
255Path Parameters
Response
Rejected transfer (hydrated)

